-GetBox- v1.0 (23.10.98)

Introduction
************

Returns coordinates of the current active window on the screen.
Read more info and instructions from DragBox archive.


Distribution
************

   Copyright (C) 1998-1999 Juha 'Asa' Pinola

   GetBox is available as freeware.  That is, it may be freely distributed
in  unmodified  form  with  no changes what so ever, but you may not charge
more than  a nominal fee covering distribution costs.  However, donations
are welcome.

   If  you use this software in a commercial or shareware software product,
please   consider  giving  the  author  and  preferably  each  one  of  the
contributors an original or registered version of your work.

   If you wish to distribute this software with a hardware product, contact
the author.  Distribution of GetBox with hardware products is not free.

   THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND ANY
EXPRESS  OR  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR A PARTICULAR PURPOSE ARE
DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY
DIRECT,  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING,  BUT  NOT  LIMITED  TO,  PROCUREMENT  OF  SUBSTITUTE  GOODS  OR
SERVICES;  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED  AND  ON  ANY  THEORY  OF  LIABILITY,  WHETHER  IN  CONTRACT, STRICT
LIABILITY,  OR  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.

****************************************


Installing
----------

Just copy GetBox to c:GetBox or somewhere else.

For faster response insert a line:
"resident c:getbox pure >nil:"	to your s:startup-sequence
or s:user-startup



****************************************


The Author
----------

   The author can be reached at the following addresses:

Electronic mail
     jpinola@cs.joensuu.fi

World-Wide Web
     http://cs.joensuu.fi/~jpinola

IRC: Asa/#amigafin/#amycoders


****************************************


Example usage:


You can change the return format:
`c:detbox.exe format "left %ld top %ld "`   (Only x,y coords)
`c:getbox.exe format "x=%ld y=%ld w=%ld h=%ld"`   (All coords)

Or change the environment variable:
`c:getbox.exe env GETBOX_DEFAULTS2`


****************************************


Command line parameters:

"X=DEF_X/N,Y=DEF_Y/N,W=DEF_W/N,H=DEF_H/N
 FO=FORMAT/K,ENV/K"

X           = Default x
Y           = Default y
W           = Default width
H           = Default height
FORMAT      = Format of return string. %ld for number (x,y,w,h)
ENV         = Set name of the environment variable. (use only names no paths! default: GETBOX_DEFAULT)

****************************************


Env variable:

GETBOX_DEFAULTS = [as command line]

Example: ( "setenv GETBOX_DEFAULTS DEF_W 600" )

(copy env:GETBOX_DEFAULTS to envarc:)


****************************************

Notes and bugs:

(factory defaults:
"X 0 Y 0 W 200 H 200 FORMAT "%ld/%ld/%ld/%ld" ENV GETBOX_DEFAULT"
)


****************************************

History:

--------------
v 1.0

+ Released with DragBox